home *** CD-ROM | disk | FTP | other *** search
/ Aminet 19 / Aminet 19 (1997)(GTI - Schatztruhe)[!][Jun 1997].iso / Aminet / game / misc / Crazy8.lha / Crazy.Eights / E.Z.Doc < prev    next >
Text File  |  1997-03-01  |  7KB  |  210 lines
  1. : Intro
  2.  
  3. +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  4. +  Easy Guide           VER 1.1                                  3/97 +
  5. +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  6.  
  7. Please note:
  8.  
  9.  
  10.    This program is PUBLIC DOMAIN  (in other words, Free!)
  11.  
  12.    Use it at your own risk  (I assume no responsibility for any damages
  13. blah, blah, blah). --- Hey, it's Free!
  14.  
  15.    You may distribute it as you wish, but this file must be included.
  16.  
  17. To use it simply shift/click the icon and the icon of the text file you
  18. want to read, or use it as the default tool for a project icon.
  19.  
  20. If the file was written for Easy.Guide, you will see a series of buttons
  21. at the bottom, allowing you to jump to the specified topics in the file.
  22.  
  23. If it's a standard text file you won't see any buttons, but you can still
  24. read the document using the gadgets on the right side and as you will see
  25. it is quite simple to add the buttons to an existing text file.
  26.  
  27. To quit click the EXIT button at the lower right.
  28.  
  29. To install, just drag the icon to wherever you like.
  30.  
  31.  
  32.  
  33. : It Has
  34. So why do I need ANOTHER text viewer anyway?
  35.  
  36. Well, this one has a few features that the other ones don't have, and
  37. it doesn't have some I thought were unnecessary (or didn't know how to
  38. do!):
  39.  
  40.   > It has Buttons for selecting topics.
  41.  
  42.     Yes, AmigaGuide has buttons too, but not everybody has AmigaGuide.
  43. And did you ever try reading an AmigaGuide document without AmigaGuide?
  44. I have, and I can assure you it's not a pleasent task!  How about
  45. writing one!  I suppose there are editors available for this, but I
  46. haven't seen one yet, and I tried writing one with a normal text editor
  47. (ONCE!) and quickly gave up.  It would have taken longer than writing
  48. the program (and I am NOT a fast programmer).  This program is not
  49. meant as a replacement for AmigaGuide, but it does provide an easy way
  50. to write and read documents while still providing a simple way for the
  51. user to locate various topics within the text.
  52.  
  53.   > Your text will still be legible if it is read with a different text
  54. viewer.  The button texts are in the program at the top of each topic
  55. (preceded by ": ") and will simply look like headers if another viewer
  56. is used.
  57.  
  58.   > It centers the document on the screen. (The whole document, not the
  59. individual lines)  Maybe this doesn't bother anyone else, but I don't
  60. like it when the text is all crammed up against the left edge of the
  61. screen with a huge blank area on the right side!
  62.  
  63.   > It's easy to write a text file to be used with it (or modify an
  64. existing file).  Wherever you want a button to appear, start your line
  65. with ": ". Then follow that with the text that should appear on the
  66. button. For example, to make a button that says "Intro" and goes to the
  67. top of the document when clicked, enter ": Intro" as the first line of
  68. your document. Be sure not to have any extra spaces after the word, or
  69. they will appear on the button too. When the file is displayed, this
  70. line will not appear, but when the user clicks the "Intro" button, the
  71. file will jump to the next line in your text.
  72.    
  73.   > When writing a file there are two things to be aware of:
  74.  
  75.   - limit your text lines to 78 characters or less. Otherwise they may be
  76.     cut off when viewed on a standard 640 pixel wide screen.  The viewer
  77.     DOES NOT WORD-WRAP.    
  78.  
  79.   - Be careful about the number of buttons used, and the length of the
  80.     text on them. If you have too many or too much "button text" you
  81.     could get to the point where you will overwrite the EXIT button
  82.     and make it impossible to exit the program.
  83.  
  84. : It Won't
  85.   ----------------------------------------------------------------------
  86.  
  87.   > What it does NOT do:
  88.  
  89.   - It doesn't read AmigaGuide texts
  90.     It will, but you will still get all the @NODE {} etc. stuff
  91.  
  92.   - It doesn't have any keyboard commands
  93.     Just point and click
  94.  
  95.   - There is no "Help" page
  96.     I don't really think it needs one
  97.  
  98.   - It doesn't print
  99.     (Unless you use a utility that allows you to print the screen)
  100.  
  101.   - It doesn't have a search facility
  102.     The point of the buttons is to make this unnecessary
  103.  
  104.   - It doesn't tell you what line you are on, how many lines there are,
  105.     what %, etc.  Do you really want to know?  If you do, the position
  106.     of the "slider" gadget on the right should give a pretty fair in-
  107.     dication of how far along you are and the size of the gadget will
  108.     show about how long the document is. 
  109.  
  110.   - It doesn't support tabs, color change commands, centering, etc.
  111.     I thought about putting these in, but again you are left with a
  112.     funny-looking text when used with some other viewers.  
  113.  
  114.   - It won't read a text file with a space in it's name! For example,
  115.     if a file is named "Help Doc" you will get a blank screen. If it
  116.     is named "Help.Doc" or "Help_Doc" it will be O.K.  I'm not sure
  117.     why this is, if anybody knows I'd like to hear.  For now, just
  118.     be sure there are no spaces in the name of your document.
  119.  
  120.  
  121. : Write to
  122.  
  123. I would appreciate any comments, questions, bug reports, complaints, etc.
  124.  
  125.    My address is as follows:
  126.  
  127.               Curt Esser
  128.               113 Pauline Avenue
  129.               Crystal Lake
  130.               Il.     60014
  131.  
  132.    Email  camge@ix.netcom.com
  133.  
  134.    All Email and letters with stamped return envelope will be answered.
  135.  
  136. -- Please let me know what machine you are using and what workbench! -
  137.  
  138. : Tech
  139.  
  140. This program was modified from one of the example programs included
  141. with my copy of Blitz Basic II.
  142.  
  143. This update was done on an A2500 with 1meg chip and 8meg fast using
  144. Workbench 3.1  (A2500 = A2000 + 68020 card)
  145.  
  146. The program was written using Blitz Basic II ver.1.7
  147.  
  148. It should work on any Amiga system with any version of Workbench.
  149.  
  150.  
  151. : History
  152.  
  153.  
  154. ------------------------------------------------------------------------
  155.  
  156. Program History:
  157.  
  158.  Ver 1.0            first release
  159.  
  160.  Ver 1.1    Should now work with any system - unfortunately to do this, I
  161.             have had to make it use the Topaz 8 font.  Does anyone know
  162.             how to tell from BlitzBasic what the name & size of the
  163.             system fonts are?  If you do, please Email or write me!
  164.  
  165.  
  166.  Class dismissed.
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  > Make sure your projects are in on time!
  178.  
  179.  
  180.  
  181. ------------------------------------------------------------------------
  182.  
  183.  
  184.  
  185. : Philosophy
  186.  
  187. This program is intended to provide an easy to use text viewer for use
  188. with game programs or small utilities, to provide an easy way for you
  189. to write docs but still allow the reader to access the desired topics
  190. quickly.  It is not intended as a general-purpose text reader (although
  191. you could use it that way) nor as a replacement for AmigaGuide which I
  192. think is great for complicated applications or documents, but overkill
  193. for short documents like my game docs.  I hope you can find some use
  194. for it!  
  195.  
  196.  
  197.  
  198. : English
  199.  
  200.  
  201.  
  202.  
  203.                                                    Have fun!
  204.                                                    See ya next update
  205.  
  206.                                                    Curt Esser
  207.  
  208.  
  209.  
  210.